home *** CD-ROM | disk | FTP | other *** search
/ La Traviata / La Traviata.iso / viewer / vga2ega4.arc / VGA2EGA3.DOC < prev    next >
Text File  |  1989-03-02  |  21KB  |  500 lines
  1.  
  2.  
  3.  
  4.           VGA2EGA (c) Copr. 1988-89 Lawrence Gozum & Marvin Gozum
  5.           ───────────────────────────────────────────────────────
  6.  
  7.                          Version 3.0  User Manual
  8.  
  9.  
  10.     DISCLAIMER
  11.  
  12.     This  product  is distributed AS IS.  The authors specifically disclaim
  13.     all  warranties  ,expressed  or implied, including ,but not limited to,
  14.     implied  warranties  of  merchantability  and  fitness for a particular
  15.     purpose  with respect to defects in the diskette and documentation, and
  16.     program  license  granted  herein,  in particular, and without limiting
  17.     operation  of  the  program  license  with  respect  to  any particular
  18.     application  use  or  purpose.  In no event shall the authors be liable
  19.     for  any  loss  of  profit or any other commercial damage including but
  20.     not limited to special, incidental, consequential or other damages.
  21.  
  22.  
  23.     LICENSING AGREEMENT
  24.  
  25.     You  may  use  this program on a TRIAL BASIS only;  this means that you
  26.     may  freely  evaluate  the  usefulness of this program for 10 DAY TRIAL
  27.     PERIOD.    Should  you  find  this program useful, you must register it
  28.     (see  last  section  of  this manual).   You will then be provided with
  29.     the latest releases of applications that will run on your system.
  30.  
  31.     You  may  freely  distribute  copies  of this program in its UNMODIFIED
  32.     state  provided  you do not include it in other software packages, with
  33.     the  exception  of distributing it as part of a bundle of Public Domain
  34.     or  shareware  programs  on a single diskette.  You may not charge more
  35.     that  $3.50 for copying and/or distributing this program in the absence
  36.     of  recognized  Users  Group guidelines (e.g., Association of Shareware
  37.     Professionals or New York Amateur Computer Club)
  38.  
  39.  
  40.     WHAT IS VGA2EGA ?
  41.  
  42.     VGA2EGA  is a utility that converts colored GIF pictures and any of the
  43.     following  listed  below  to  error-distributed, dithered, 16-Color EGA
  44.     pictures.   You can optionally save 4 planes for each red, green, blue,
  45.     and  white(grey)  plane  to  .PCX  (ZSoft)  files  as  a  Desktop Color
  46.     Seperator  (DCS),  where Cyan=Grn+Blu, Magenta=Red+Blu, Yellow=Red+Grn.
  47.     You  can  view pictures in low-res EGA 320x200x16 mode (32KB EGA cards)
  48.     or as high as 800x600x16 in EEGA modes.
  49.  
  50.     1)   ANY  colored  GIF picture (32 colors and up recommended), with any
  51.          size (up to 2048 x 2048 x 256).
  52.  
  53.     2)   ANY VIEWABLE VGA/MCGA 320x200x256 picture captured with VGACAP;
  54.  
  55.     3)   VGACAD pictures;
  56.  
  57.     4)   16-color pictures converted to 320x200x256 with EGA2VGA.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.     VGA2EGA  requires,  at  the minimum, a 32KB EGA card (320x200x16 mode).
  71.     For  viewing,  VGA2EGA  supports  video  modes  in  EGA 320x200x16, EGA
  72.     640x200x16,  EGA  640x350x16, EEGA/VGA 640x480x16, and hi-res EEGA/SVGA
  73.     modes up to 800x600x16.
  74.  
  75.     VGA2EGA  converts  your  colored  pictures  to  4-plane colored dithers
  76.     using  a unique error-distribution algorithm; it uses a Floyd-Steinberg
  77.     matrix  with  Stucki  filter  values (8,4,2,2).  Users can individually
  78.     adjust  the  CMY  and/or  RGBI  color  levels and RGBI contrast levels,
  79.     dither density, and image size to suit their tastes.
  80.  
  81.  
  82.     WHAT IS VGACAP ?
  83.  
  84.     VGACAP  is  a  terminate-stay-resident (TSR) utility that allows you to
  85.     capture  the 256 color palette and screen in the 320x200x256 color mode
  86.     and  save both the palette and screen in "Bloadable" formats.  VGACAP's
  87.     main  purpose  is to capture and "Bsave" the pictures of commercial and
  88.     Shareware viewing/painting/graphics/CAD programs.
  89.  
  90.     VGACAD  (one  of  the  first  256  color  paint/CAD  shareware programs
  91.     distributed  in  the Public domain) will load the captured pictures for
  92.     extensive image processing and editing.
  93.  
  94.  
  95.     REQUIREMENTS
  96.  
  97.     EGA  32KB  (minimum).    We  are  stating that about 512KB of memory is
  98.     required, although it uses about 2/3 of that.
  99.  
  100.     You  MUST have a VGA or MCGA adaptor (at least BIOS compatible) present
  101.     and  an analog monitor to use VGACAP.  VGACAP uses less than 2K of your
  102.     available memory !
  103.  
  104.  
  105.     HOW TO USE VGACAP
  106.  
  107.     Run  VGACAP  before  entering  your  painting/CAD  or digitized picture
  108.     viewer.       Press  <ALT-F10>,  while  viewing  your  picture  in  any
  109.     drawing/paint/CAD  program.  Your  current  screen  and palette will be
  110.     saved  in your default drive and directory in the standard Bsave format
  111.     for all BASIC programs.
  112.  
  113.     The  first  time  you  run  the  program  it  will save your screen and
  114.     palette  to SCREEN00.BLD and SCREEN00.PLT respectively.  If there is an
  115.     existing  SCREENxx.BLD  or SCREENxx.PLT file, then it will increment to
  116.     the  next  higher number.  You can use your favorite memory managers to
  117.     remove this TSR or reboot to release it from memory.
  118.  
  119.          Note:    When in DOS or using a picture viewer (e.g., PICEM, VPIC,
  120.          VGAGIF)  or  application which requires a keypress to continue, it
  121.          is necessary to hit another key after hitting the 'HOTKEY'.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.     LOADING PICTURES INTO VGA2EGA
  137.  
  138.     Two  formats  are  accepted  by VGA2EGA: GIF and BLD/PLT files;  At the
  139.     start  of  the  program,  you will be prompted to select [G]IF or [B]LD
  140.     files to to selected or [Q]uit to exit.
  141.  
  142.     When  loading  GIF  pictures, if you have a VGA/MCGA card, VGA2EGA will
  143.     display  the  picture as it decodes it and show its conversion to a 256
  144.     grey  scale  picture.    All  other  cards  will load in memory; GIFPUB
  145.     automatically senses if you have a VGA/MCGA or SuperVGA card.
  146.  
  147.     All  pictures  are  interpolated  to  a  320x200  size.  As such, LARGE
  148.     SuperVGA  GIF  files  (e.g., 640x480x256, 800x600x256 and 1024x768x256)
  149.     are   interpolated   to   320x200x256;  succeeding  updates  will  take
  150.     advantage  of  the  rich  color  information  in LARGE GIFs by creating
  151.     virtual  disk buffers.  SQZGIF is recommended for LARGE GIF pictures to
  152.     retain more color information for better color rendition.
  153.  
  154.     16-color  EGA/EEGA/VGA pictures will also be interpolated; it is highly
  155.     recommended  that  you  use  EGA2VGA  to  process  such pictures before
  156.     loading into VGA2EGA.
  157.  
  158.     You  can  select  any  filename  by  moving a highlighted bar (with the
  159.     arrow  keys)  and pressing the <return> key.  Pressing <Spc> allows you
  160.     to  select a different PATH, while <Esc> exits.  When selecting a *.BLD
  161.     file,  be  sure  it  has a corresponding  *.PLT file or a error message
  162.     will result.
  163.  
  164.     PATHs  MUST  end  with a backslash character "\" or your specified PATH
  165.     will  be rejected (an error beep will result).  The following are legal
  166.     PATH examples:
  167.  
  168.               "A:\"
  169.               "B:\"
  170.               "C:\GIF\"
  171.               "D:\GIF\VGA\LARGE\"
  172.  
  173.     Every  captured  picture,  VGACAD picture, converted EGA2VGA or SSQZGIF
  174.     or  MAC2GIF  picture  will have two files: the screen and palette.  The
  175.     extension .BLD stands for BLoaD and .PLT for PaLetTe.
  176.  
  177.     THE MAIN MENU
  178.  
  179.     After successful loading of your picture you will see these options:
  180.  
  181.          (1)  32 KB RAM  STD EGA  320x200x16
  182.          (2)  64 KB RAM  STD EGA  640x200x16
  183.          (3) 128 KB RAM  STD EGA  640x350x16
  184.          (4) 256 KB RAM  STD EGA  640x480x16
  185.  
  186.          (L)aboratory    STD EGA  640x350x16
  187.          (F)ine Tuning
  188.          (N)ew Picture
  189.          (Q)uit
  190.  
  191.     Select the letter or the number to initiate that function or option.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     RESIZING OPTIONS
  203.  
  204.     Whenever  you  select  a  video  mode  to be created you will see these
  205.     options (this screen shows blanks filled with examples).
  206.  
  207.               Video Mode/Aspect Ratio: EGA 640x350
  208.               Image Width  (pixels)  : 640
  209.               Image Height (pixels)  : 350
  210.  
  211.               Resizing Factor (1-100): 100%
  212.               Pathname               : C:\GIF\
  213.               Filename               : NONAME.GIF
  214.  
  215.     Image  Width  and  Height are set by the video mode you have chosen and
  216.     cannot be changed except when e[X]tended EGA User Mode is selected.
  217.  
  218.     In  this  example,  the  Image Width and Height matches the full screen
  219.     since  Resizing Factor is 100%; if it were 50% then each number will be
  220.     cut  in  half.    To  maintain your aspect ratios in EEGA modes, always
  221.     start with a Resizing Factor of 100% then reduce it later.
  222.  
  223.     When  a  standard  EGA  video mode or preset EEGA mode is selected, the
  224.     Image  Height  and Width will always follow what is stated in the Video
  225.     Mode/Aspect  ratio  line;  only the Resizing Factor can be altered.  To
  226.     retain an old setting, press return and the setting will remain.
  227.  
  228.  
  229.     VIEWING & SAVING
  230.  
  231.     While  viewing the picture in EGA 640x350x16 mode or any supported EEGA
  232.     mode  (up  to 800x600x16), you can change the palette to alter the tone
  233.     of  the picture.  Users with 32KB and 64 KB EGA cards cannot change the
  234.     palette  since  it  is limited to 16 colors and optimized for 8 colors.
  235.     All  other  users have 9 EGA palettes to choose from.  Simply press the
  236.     number  from  1  to  9 to see the effect of a different palette on your
  237.     picture.
  238.  
  239.     If  you  are happy with the results, you can press return and the image
  240.     will be saved with the proper screen and image data in a GIF file.
  241.  
  242.     If  you  intend  to use VGA2EGA as a Desktop Color Separator, press [P]
  243.     to  save  4  .PCX  files;  each file will correspond to the Red, Green,
  244.     Blue   and   White(Grey)   plane   of  the  picture  and  are  labelled
  245.     accordingly.
  246.  
  247.     Since  different  color  printers (particularly thermal) have different
  248.     CMY  mixtures,  saving to RGBI files allows the user the flexibility to
  249.     determine  if  one  component  of CMY is higher than the other.  CMY or
  250.     Cyan-Magenta-Yellow  can be interpreted as (Cyan-Blue, Magenta-Red, and
  251.     Yellow-Orange)  or  (Cyan-Green,  Magenta-Blue  or Yellow-Green) or any
  252.     combination  thereof;  as such, you decide which combination of RGBI is
  253.     appropriate  for your CMY separation; there are 8 possible combinations
  254.     for  CMY.    Remember,  CMY is made by combining Grn+Blue, Red+Blu, and
  255.     Red+Grn primary colors respectively.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     FINE TUNING
  269.  
  270.     To  get the BEST color dithering, we suggest that you experiment with a
  271.     small  image (e.g., EGA at 50%) while interactively adjusting the color
  272.     levels,  contrast  levels  and  dither  density levels.  When satisfied
  273.     with  the  results,  you  can  progress  to  larger  sizes  up  to EEGA
  274.     800x600x16.
  275.  
  276.     When  you  select  (F)ine  Tuning, you can adjust the global amounts of
  277.     Red,  Green,  Blue  and  White(grey)  in you picture.  At default it is
  278.     100%;  this  can be increased up to 200%.  16KB and 32KB EGA users need
  279.     not  adjust  the  White(grey) level since only 3 planes or 8 colors are
  280.     used.
  281.  
  282.     While  "fine  tuning",  you  can adjust the contrast levels for each of
  283.     the  RGBI  planes.  Increasing the contrast will increase the amount of
  284.     "black"  in  the  picture by making a sharp cutoff (i.e., no color will
  285.     be plotted).
  286.  
  287.     Dither  Density  is  how  closely  packed neighboring pixel will be; at
  288.     default  this  is set to 1 - the highest density possible.  If you want
  289.     to  "spread  the  dots"  in a less packed manner, you can increase this
  290.     level up to 200.
  291.  
  292.  
  293.     LABORATORY
  294.  
  295.     Selecting  (L)aboratory  will  put  you in EGA 640x350x16 mode and will
  296.     show  your  picture  with  70% of the size; you can reduce the size but
  297.     cannot  exceed  70%.    While in the Lab, you can alter the red, green,
  298.     blue,  grey,  cyan,  magenta  and yellow color levels and RGBI contrast
  299.     levels  as  you would with the "fine tuning" option.  However, here you
  300.     can interactively see the change.
  301.  
  302.     To  select  a plane for modification press A,R,G,B,C,M,Y,W; each letter
  303.     refers  to  ALL,  red,  gren,  blue,  cyan,  magenta, yellow, and white
  304.     respectively.
  305.  
  306.     Once  a  plane  has  been  selected,  pressing the "plus"(+) key or the
  307.     "minus"(-)  key will increase or decrease, the color level or the color
  308.     contrast   of  selected  plane(s).    The  <spacebar>  toggles  between
  309.     contrast and color level modification modes.
  310.  
  311.     A  MODE  indicator  will  tell you what your current plane selection is
  312.     and  what  modification  mode  is active.  "A Color" will mean that ALL
  313.     color  levels of all 4 planes will be affected.  "R Contrast" will mean
  314.     that  only the RED color level will be affected.  An [U]ndo function is
  315.     provided  to  reset  all  color  and  contrast values; so, feel free to
  316.     experiment  !    Below  the  displayed  image are bargraphs showing the
  317.     corresponding RGBWCMY color levels and RGBI contrast levels.
  318.  
  319.     While  in  the (L)aboratory you can select from 9 EGA palettes and save
  320.     the  finished  image.    If  you picture looks good in the Lab; it will
  321.     look infinitely better when expanded to large sizes or in EEGA modes.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.     PRESET AND USER EXTENDED EGA (EEGA) MODES
  335.  
  336.     Press  the  [H]elp  screen  option when using Present or E(x)tended EGA
  337.     User  Modes  for more information of various EEGA cards supported.   We
  338.     have built-in 8 Preset EEGA modes.
  339.  
  340.     You  can  set any Extended EGA mode that your video card supports up to
  341.     800x600x16  IF  YOUR  EEGA  CARD  SUPPORTS  THE  STANDARD  BIOS CALLING
  342.     CONVENTION  FOR SETTING VIDEO MODES.  The Video7 Vega and Everex EVA480
  343.     cards  are  among the few that require their own method for setting the
  344.     EEGA mode; use the (E)verex and (V)ideo7 preset modes instead.
  345.  
  346.     In  general,  all  Chips  & Technologies (C&T) chip based cards use the
  347.     standard BIOS convention for calling EEGA modes.
  348.  
  349.     SVGA  modes  (e.g.,  1024x768x16)  do not follow the EGA memory mapping
  350.     since  the  number  of  bytes  exceed 256KB and require memory banking;
  351.     thus,  800x600x16  IS  THE  LIMIT  (until we upgrade VGA2EGA to support
  352.     SVGA 16 color modes for specific SVGA cards).
  353.  
  354.  
  355.     WARNING:  PRESET  AND  USER  EXTENDED  EGA  MODES  ARE NOT DETECTED NOR
  356.               ERROR-CHECKED  !  IF YOUR CARD DOES NOT SUPPORT IT, DON'T USE
  357.               IT;  UNPREDICTABLE  RESULTS  WILL  OCCUR.    CHECK YOUR VIDEO
  358.               CARD'S  USER MANUAL FOR VIDEO MODE AVAILABILITY, MODE NUMBERS
  359.               AND SCREEN DIMENSIONS TO BE USED.
  360.  
  361.  
  362.     REGISTRATION
  363.  
  364.  
  365.     BONUS:    Registered  users  of VGACAD v1.4-1.5, VGA2EGA v1.0, SQZGIF
  366.               v1.0-v1.3,  GIFDOT  v1.0-1.3,  MAC2GIF  v1-2 and/or EGA2VGA
  367.               v1-3  and/or  GIFPUB  v1.0-v1.4  are considered registered.
  368.               Copy  your  REGISTER.OVL file into the directory of VGA2EGA
  369.               and  it  will operate as a registered version.  IF YOU HAVE
  370.               NOT  REGISTERED  ANY  OF  THESE  PROGRAMS,  DO SO NOW; when
  371.               VGACAD  v1.60  is  released,  all new releases will require
  372.               REGISTER.V16 to operate as a non-shareware version.
  373.  
  374.  
  375.     For  19.95  (outside  of U.S.A. add USD $15.00) you will be entitled to
  376.     the  latest  update  of  VGA2EGA and REGISTER.V16 file (when released).
  377.     The  following  programs  listed  below  are  provided  (latest copy or
  378.     update)   to   registered   users.     As  much  as  possible,  we  are
  379.     reprogramming  all  utilities  to  work  with  ANY video card; programs
  380.     that,  at  present,  work  with  ANY  video  card  are: GIFPUB, GIFDOT,
  381.     EGA2VGA  (v2-3), MAC2GIF and SQZGIF.  We intend to modify all utilities
  382.     to  have  device-independent  graphics  capabilities  (with the obvious
  383.     exception  of  VGACAD, VGACAP, VGA2EGA, and CGA2VGA). If you upgrade to
  384.     VGA,  please  inform  us  as  soon  as possible so that we may send you
  385.     VGA-dependent releases too.
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.     * Device-independent utilities
  401.  
  402.          GIFPUB  -  converts  256 color GIFs to B&W images of varying sizes
  403.          for  desktop publishing/printing as .PCX (ZSoft format for Ventura
  404.          Desk  Top  Publisher,  First Publisher, Publisher's Paintbrush, PC
  405.          Paintbrush+)  or  rename  files  to  .PCC  for  importing in Aldus
  406.          Pagemaker.
  407.  
  408.          GIFDOT  -  converts  256 color GIFs to B&W images of varying sizes
  409.          for  printing  on  IBM  and  Epson  compatible  printers (separate
  410.          drivers).    Several  print  sizes  with  perfect  aspect  ratios.
  411.          Variable  Brightness  and  Contrast  Stretching.  Single or Double
  412.          pass printing.  Histogram Analysis
  413.  
  414.          SQZGIF  -  converts  LARGE  GIF  pictures (up to 2048x2048x256) to
  415.          320x200x256  using  interpolation and "color averaging" techniques
  416.          to  blend/smooth  "jaggies"  inherent in reducing LARGE GIFS while
  417.          retaining  a  maximum  of  color  information.  Version 1.3 is now
  418.          300% FASTER and features the same user interface.
  419.  
  420.          MAC2GIF  -  converts .MAC ("readmac") pictures to 5-16 grey shades
  421.          or  color  and  saves  results  as .GIF or BLD/PLT file, and other
  422.          formats;  graphics  are  viewable  in  VGA, MCGA or EGA - no video
  423.          card is required for direct Black & White conversion to GIF.
  424.  
  425.          EGA2VGA  (v2.0)  -  converts  GIFs  (16  colors  and below) or ANY
  426.          VIEWABLE  2-16  color EGA/EEGA/VGA picture to 320x200x256; creates
  427.          256  new  colors;  outputs  load  directly  to GIFPUB, GIFDOT, and
  428.          VGACAD.    If  you  load converted MAC2GIF pics you can smooth and
  429.          convert  Black  &  White  images  to  grey  shades;  B&W  GIFs and
  430.          captured pics will also be "smoothed" into grey shades.
  431.  
  432.  
  433.     * Device-dependent utilities/applications
  434.  
  435.          VGACAD  -  extensive  paint/image  processing program for VGA/MCGA
  436.          users;      v1.50   features  extensive  paintingcapabilities,  an
  437.          integrated   GIF  interface,  Airbrushes,  color  and  grey  image
  438.          processing  functions (smoothing, noise removal, shading, contrast
  439.          stertching,  edge  detection,  high frequency-boosting, ... more),
  440.          Bezier/spline  curves,  multi-featured Cut&Paste, variable sizing,
  441.          multi-directiona   256-color   gradient  fills,  256  color  16x16
  442.          pattern fills, and a LOT of other 256-color capabilities.
  443.  
  444.  
  445.     Whats next ?
  446.  
  447.     SYNPCX  is  utility  to convert dithered, monochrome .PCX (Zsoft) files
  448.     to  smooth  grey shades.  This utility is primarily designed to convert
  449.     scanned  (e.g.,  Logitech  &  DFI  hand scanners) Black & White images,
  450.     saved  to  a  .PCX  file,  for  use  and  image processing with VGACAD,
  451.     redithering/resizing   with   GIFPUB,  printing  with  GIFDOT,  or  EGA
  452.     conversion  with  VGA2EGA.   SYNPCX will be graphics device independent
  453.     (No Video Required).
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.     On  the  longer  term,  you  can  expect  radical changes in VGACAD and
  467.     VGA2EGA.      VGA2EGA  updates  will  include  color  optimization  and
  468.     maximization  to  take  full  advantage  of its 16 out of 64 color with
  469.     color   dithering.    We  are  also,  developing  VGASHW  (a  256-color
  470.     presentation  system), VGACBT (the PROGRAMMABLE Computer-Based Training
  471.     counterpart  of VGASHW) AND MANNEQUIN (what "Weird Science" tried to do
  472.     in  the  movie  it  will  do  on  the  computer  screen  with potential
  473.     applications  for  Advertising  and Fashion Design, aside from creating
  474.     your own artistic nudes).
  475.  
  476.     If  you  support  maverick authors like us, we will continue to develop
  477.     innovative  products  like  nothing  seen commercially - otherwise they
  478.     will,  as  many (sigh!) good Shareware programs, simply "DIE" from lack
  479.     of  support  !    Compare the cost/benefit ratio of any of our products
  480.     with   commercial   products;   we  want  to  continue  supporting  and
  481.     developing   these   products.     Please  support  the  User-Supported
  482.     (Shareware)  concept;  you, and you alone, determine whether it will be
  483.     worthwhile to continue developing.
  484.  
  485.     To register, send in the registration form and check payable to
  486.  
  487.                              Dr. Marvin Gozum
  488.                       2 Independence Place Apt. 303-2
  489.                             6th & Locust Street
  490.                           Philadelphia, PA 19106
  491.  
  492.  
  493.     NEW!      3.5" disk users:  We are now supporting this format.
  494.               If you want your updates in this format, add $10.00.
  495.  
  496.     ───────────────────────────────────────────────────────
  497.     Graphics Interchange Format and GIF are trademarks (tm)
  498.     of CompuServe Inc. an H&R Block Company.
  499.  
  500.